Set Failure Action

Specifying a failure action for a business task included in your gate configuration enables you to control N4 behavior in the event that a business task fails and returns an error. You can also use the failure action code to third-party systems to enable them to configure an appropriate action in case of a failure.

To set the failure action for a business task:

1. Select the business task and ensure that the business task is included in the gate configuration.

2. Select Actions Set Failure Action.

N4 displays a form with the Action on Failure drop-down list.

3. From the Action on Failure drop-down list, select one of the following failure actions for the selected business task:

• RETRY_XPS: Re-sends the information to XPS if XPS is unavailable on the first attempt.

If XPS does not return a position to N4, the following error message is displayed:

Requesting position for Container - NO RESPONSE

• RETRY: Allows the truck driver to re-enter any incorrect gate transaction data.

• RETRY_PIN: Allows a user to re-enter the PIN number.

• SCAN_FAIL: Indicates that the scanner in the gate lane misread the gate transaction data.

A gate clerk can use the Gate Lane Monitor view (on page 1) to fix gate scans.

• NO_INSPECTION: Indicates that there is no inspection.

• TROUBLE_LANE: Indicates that the gate clerk must fix the gate transaction data while the truck is in the gate lane

If you do not specify the failure code for a business task at an outgate stage, N4 uses Trouble - Stay in Lane as the default failure code.

• TROUBLE_DESK: Indicates that the gate transaction status must be set to Trouble and the gate transaction errors must be fixed at the trouble desk and not in the gate lane

If you do not specify the failure code for a business task at an ingate stage, N4 uses Trouble - Desk as the default failure code.

• GOTO: Indicates that the driver must be re-directed to another exchange area or gate stage.

• EXIT: Indicates that the gate transaction data cannot be fixed and the driver must exit the terminal

• GATE_FAILURE: Indicates a complete gate system failure

4. Click OK.

If you do not have a trouble desk at your site, do not set the failure code for any business task and ensure that the Open Barrier on Trouble check box in the Gate Stage form (on page 1) is not selected.

If multiple business tasks fail, N4 returns the most severe failure codes. The order of severity of the failure codes is as follows:

• RETRY (Least severe)

• SCAN_FAIL

• TROUBLE_LANE

• TROUBLE_DESK

• EXIT

• GATE_FAILURE (Most severe)

N4 returns the failure code as an attribute in the process-truck-response element and also in the truck-visit and truck-transaction elements, if present.

The failure code in the truck-transaction element is the most severe failure code for a gate transaction. Therefore, if one gate transaction returns OK and one returns RETRY, the GOS knows which gate transaction to retry.